home *** CD-ROM | disk | FTP | other *** search
/ Mac Mania 2 / MacMania 2.toast / Demo's / Tools&Utilities / Newton / FloatingTime 1.7 Folder / FloatingTime 1.7 / Read Me 1.7 < prev   
Encoding:
Text File  |  1994-05-16  |  7.2 KB  |  175 lines  |  [TEXT/R*ch]
  1. Floating Time (A Newton Utility)
  2. Version 1.7
  3.  
  4. written by     Thomas V. Fischer
  5.             TVF Productions
  6.  
  7. Date:    16 May 1994
  8.  
  9. Description:
  10.  
  11.     Floating Time is a small simple utility for the Newton MessagePad.
  12.      
  13.     The purpose of this small Newton application is to display the time and
  14.     battery level on a permanent basis. It also will stop the MessagePad from
  15.     shutting down when it is plugged in, this can be helpful when you need to
  16.     view your notes while working at something else. You can also choose to
  17.     resize the window and set preferences to let the Newton shutdown normally
  18.     or start Floating Time as a small window.
  19.     
  20. Why does it exist?
  21.  
  22.     Floating Time was originally conceived because of the way I started to work
  23.     with my MessagePad. I do a lot of travelling and have a tendency to write
  24.     my programming plans (and sometimes code) during these trips.
  25.     I would then arrive back at my place of work and use my MessagePad as a
  26.     reference. As I would get side tracked and sometimes disturbed the
  27.     MessagePad would turn itself off. I found that I would spend half my time
  28.     turning it back on instead of working.
  29.     Hence, the need for something discreet and useful to stop the MessagePad
  30.     from turning itself off.
  31.     
  32. Usage:
  33.     
  34.     Install the FloatingTime.pkg using the Newton Connection Kit (or your
  35.     preferred method).
  36.     Once installed tap (or is it click) on the Floating Time icon that appears
  37.     in your 'Extras' draw.
  38.     You may either display the Time or the Date. Select your display preference
  39.     using the pop up label (next to the diamond).
  40.     You can use the 'Off' button to turn off the newton immediately, therefore
  41.     overriding your preference to not shutdown. This also avoids wear and tear
  42.     on the Power switch.
  43.     Two preferences, 'Don't turn off the Newton when plugged' and 'Start with
  44.     small window', were added to the application. I think they are basically
  45.     self explanatory. They are located under the Newton System Prefernces icon
  46.     in the Extras Drawer.
  47.     You can now resize the window by clicking in the small Macintosh style
  48.     resize box in the top right hand corner.
  49.     
  50. Changes since version 1.0:
  51.     - Added a power off button.
  52.     - Made the window resizable.
  53.     - Added preferences, accessible in the Newton preferences.
  54.         (as it should be according to PIE DTS).
  55.     - Fixed a few minor bugs... (no details!)
  56.     - Change the size of the Extras Drawer name.
  57.     - Change the Creator of the file to 'DOCK' for the Connection Kit.
  58. Changes since version 1.5:
  59.     - Fixed the Date/Time picker disappearing act.
  60.     - Fixed some cloned slots that weren't eating memory. Set them to nil.
  61.     - Can no longer resize the palette beyond the screen size.
  62.  
  63. Bugs and Others:
  64.  
  65.     Nobody is perfect, so there may still be some bugs. Please let me know if
  66.     you find any and how to reproduce them.[This is very important!]
  67.  
  68. Notes for the More Technically Inclined:
  69.  
  70.     The choice between Time and Date display is not only for display
  71.     functionality but also for battery conservation.
  72.     The time display is called every second on an idle event.
  73.     The date display is only called every minute.
  74.     This is useful when you wish to use Floating Time while on battery power.
  75.     The preferences store is removed when the package is removed. This avoids
  76.     keeping unwanted data around when you don't want Floating Time around
  77.     anymore.
  78.  
  79. Lacunas and Known Problems:
  80.  
  81.     To test the "plugged in" state of the MessagePad, I have only one method
  82.     currently. This method is to test BatteryLevel(0) equal to 100. This
  83.     however is also true for new batteries and just recharged batteries. This
  84.     is somewhat of a probelm as it stays at level 100 for quite a while.
  85.     [ If anybody has a better idea, please let me know].
  86.     
  87. The Future:
  88.  
  89.     Should add a plugged in icon! (Don't know if this will be done yet as the
  90.     small utility is getting to be very big!)
  91.     Disclaimer on adding new elements:
  92.         When I originally started making this utility, I wanted it to be small
  93.         and useful. It has now reached 18+K but it is still useful. As the size
  94.         is getting a bit big, I'll probably not add anything new for the moment
  95.         until I figure out a way to optimize the generated code even more.
  96.         
  97. Sharewares, Freewares, Otherwares and Do What You Want Wares[DWYWW]:
  98.  
  99.     I don't believe that Floating Time is a incredible application in its own
  100.     right. I spent some of my free time programming the application, but it is
  101.     a small and simple utility.
  102.     
  103.     To this extent I don't wish to release this as shareware. Therefore, I am
  104.     declaring this a Do What You Want Ware. If you care to send me a little
  105.     something, please send! [PS: If you live in the United States, please
  106.     contact me if you wish to send me a check]. The little something can be
  107.     cash, postcards, e-mail and collector's items ( I collect shot glasses with
  108.     logos). Let me know you are out there and tell me what you think.
  109.     
  110.     NTK DEVELOPERS: The code is of course my property, except for the parts 
  111.     that of course belong to Apple. However, I am willing  to give out the
  112.     full Floating Time Project source code for a minimal fee. If you are 
  113.     interested in seeing how I programmed Floating Time, please send me:
  114.                     US$ 15 or 100 French Francs.
  115.     [PS: If you live in the United States, please contact me 
  116.         if you wish to send me a check in US Dollars]
  117.  
  118. Distribution:
  119.     
  120.     Floating Time may be freely distributed on any non-profit media and/or
  121.     Information services (this includes    disks, Compuserve, AppleLink, etc).
  122.     This is of course under the condition that the package not be altered in
  123.     anyway shape or form.
  124.     
  125.     The package should include the following files:
  126.         FloatingTime.pkg
  127.         Read Me (this file).
  128.     
  129.     Companies like B-MUG and Educorp, please contact me about distribution.
  130.         
  131. How to Reach the Author:
  132.  
  133.     You can reach me in the following ways.
  134.     
  135.     Regular Mail:
  136.         Thomas V. Fischer
  137.         TVF Productions
  138.         103 rue du Pontel (Bat A)
  139.         F-71800 St. Germain en Laye
  140.         FRANCE
  141.      
  142.      E-Mail:
  143.          CompuServe: 100040,41
  144.         AppleLink:    TVF.PROD
  145.  
  146. Legal Stuff:
  147.  
  148.     If I remember this right, the following products/names/trademarks need to
  149.     have their ™,©     and ® (except I don't remember which goes where):
  150.         Apple, MessagePad, Newton Connection Kit, Newton Developers Kit
  151.         
  152.     Well now for my legal stuff! (My lawyer says I need this!)
  153.  
  154. Disclaimer:
  155. In using this software, you understand and agree that this software is provided
  156. “as is” without warranty of any kind.  The entire risk as to the results and
  157. performance of using this software lies entirely with you, the user.  The author
  158. does not make any warranties, either expressed or implied, including but not
  159. limited to implied warranties of merchantability and fitness for a particular
  160. purpose, with respect to this software.
  161.  
  162. In no event shall the author be liable for any consequential, incidental, or
  163. special damages whatsoever (including without limitation damages for loss of
  164. critical data, loss of profits, interruption of business, and the like) arising
  165. out of the use or inability to use this software.
  166.  
  167. Although the author would appreciate any feedback and bug reports, the author
  168. shall not be responsible for correcting any problems which you discover or
  169. otherwise help you maintain and use this software.  Furthermore, the author may
  170. at any time replace, modify, alter, improve, enhance or change this software.
  171.  
  172. Floating Time is "Do What You Want Ware". I retain all rights to this software. 
  173. ( ©1993, by TVF Productions. All Rights Reserved. Some Parts ©1993 by Apple)    
  174.     
  175.